Book Contents

Options on the General tab of the Goto Display Button Properties dialog box

The following table shows the options on the General tab of the Goto Display Button Properties dialog box.

Options

Descriptions

Appearance

Specify the object's appearance in this area.

Border style

Select a border style for the object.

If the object shape is circle or ellipse, the available border styles are None and Line.

Border width

Type the number of pixels for the width of the object’s border.

Back style

Specifies the object background. Available options are:

  • Solid. The object’s background is filled with a solid color specified in the Back color option.
  • Transparent. The object’s background is not filled and any objects behind it show through.
  • Gradient. The object's background is filled with a linear gradient color.

     

Pattern style

Select a pattern for the object. The pattern appears on the face of the object. The pattern does not cover the object’s border, caption, or image (if any are defined for the object). If the object’s back style is transparent or gradient, the pattern is not visible.

Shape

Select the shape of the object. If the object shape is circle or ellipse, the application applies properties such as size and position by measuring in relation to the object’s bounding box.

Border uses back color

Select this check box to use the object’s background color for the border of the object.

Clear this check box to use the selected Border Color.

Specify the background color and the border color on the States tab.

Back color

This box shows the current background color for the object. Click it to select another color.

If the background style is transparent, the application does not use this background color.

If the background style is gradient, click it to bring up the Gradient Fill dialog box to configure the gradient fill.

Border color

This box shows the border color for the object. Click it to select another color.

If Border uses back color is not selected, this color appears at run time.

Pattern color

This box shows the current pattern color for the object. Click it to select another color.

Highlight color

This box shows the current highlight color. Click it to select another color.

The object's border, if any, changes to the highlight color when the operator presses the button at run time.

Blink

Select this check box if you want the object’s background to blink at run time. The blink rate is twice per second.

If a pattern style is selected, the pattern also blinks.

Display settings

 

Display

Click the Browse button (...) to open the Component Browser and select the display to open when the button is pressed. The list contains all of the graphic displays in the project.

Use variable display

Select this box to use the tag/expression content that is set on the Connections tab. If this check box is not selected, the goto button uses the display name specified in the Display field.

Parameter file

Select this option if the display's run-time parameter values will be provided by a parameter file. Click the Browse button (...) to open the Component Browser and select the parameter file to run when the button object is pressed.

Parameter list

Select this option if the display's run-time parameter values will be provided by a parameter list. Click the Browse button to open the Tag Browser and select the tag or tags to add to the list.

Display position

Select this check box to specify where the display is positioned when it is opened. If you leave this check box cleared, when the display is opened, it is positioned according to whatever is specified in the Position options in the Properties tab of the Display Settings dialog box. These properties apply only to On Top displays. They are ignored for a Replace display.

Top position

If Display position is selected, type the number of pixels from the top of the screen to position the display. This property applies only to On Top displays (with or without the Cannot Be Replaced option).

Left position

Type the number of pixels from the left edge of the screen to position the display.

This property applies only when Display position is selected and to On Top displays (with or without the Cannot Be Replaced option).

Use Variable Display Position

Select this check box to use the tag/expression content that is set on the Connections tab for the Top Position and Left Position. If this check box is not selected, the display is positioned as specified by the settings associated with the Display position check box on this tab (General tab) or as specified on the display's properties dialog box.

Touch margins

You can specify a touch-insensitive margin inside the button’s edges. If the operator presses on the touch-insensitive margin, the button press is not registered.

Horizontal margin

Specifies the number of pixels for the distance inside the left and right edges of the button where the button will not be touch sensitive.

Vertical margin

Type the number of pixels for the vertical touch margin. The vertical margin is along the button’s top and bottom edges.

Other

 

Audio

Select this check box to sound an internal beeper when the object is pressed.

If the computer running the project does not have an internal beeper, the object press does not trigger a beep.

See also

Create Goto Display buttons

Set up a caption and image for a button

How the Goto Display button works at run time

Configure the gradient fill

Set up general properties for a Goto Display button